home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Software Vault: The Gold Collection
/
Software Vault - The Gold Collection (American Databankers) (1993).ISO
/
cdr45
/
cdp_126.zip
/
CDP.DOC
next >
Wrap
Text File
|
1993-04-14
|
31KB
|
610 lines
CDPlay
Version 1.26
September 29, 1992
This program is Copyright 1992 by Randy Rathbun. Turbo C++
is Copyright 1987, 1990 Borland International, Inc. Microsoft
CD-ROM extensions Copyright Microsoft, Inc.
This program is Shareware. You are granted a trial period
of ten (10) days to try it out. If, after this period, you
continue to use it, you must register it by sending $10US + $3US
for Shipping and handling to Randy Rathbun. See the Order Form
at the end of this document for more information.
For the most up to date Shareware version of CDPlay, call
The Ham Shack BBS at (816)796-6695. 24 Hours, 300/1200/2400
Baud, no parity, 8 data bits, 1 stop bit (FIDONET 1:280/19 - file
freqable as CDPLAY.ZIP)
-or-
The Sounding board BBS (816) 361-9294, 24 Hours, 300/1200/2400
baud, no parity, 8 data bits, 1 stop bit (FIDONET 1:280/32 - file
freqable as CDPLAY.ZIP)
Disclaimer
The author (Randy Rathbun) is not to be held liable for any
damages caused by the use or misuse of this program. This pro-
gram is provided 'AS-IS' with no warranty, either expressed or
implied.
Owners of the REGISTERED version of CDPlay are granted a one
(1) year warranty on the media in which CDPlay is distributed.
Owners of the REGISTERED version must send their original CDPlay
disk (+$3US for postage and handling) to Randy Rathbun, 18602
Cheyenne Drive, Independence, MO 64056.
Terms of Distribution
Since CDPlay is Shareware, you may not sell it. Only the
author (Randy Rathbun) may sell the program as a REGISTERED COPY.
You may not charge others for this (Shareware) program. It must
be given away. Users groups and other commercial interests
(Shareware distributors, for example) may charge a small fee for
the media on which CDPlay is distributed. This fee may not
exceed $5 for magnetic media, and $1000 for optical media.
Users groups and commercial interests which distribute
CDPlay are encouraged to let me (Randy Rathbun) know that you are
distributing CDPlay. We want to know how it is getting around!
As a REGISTERED USER you are allowed to make copies of this
program FOR YOUR OWN USE. This includes things such as install-
ing it on your hard drive, making backup copies, etc.
Since you have a REGISTERED version, if we find that you
have made illegal copies of this program, we will send our
friend, Vinnie Goombatz, over to rip your lungs out. In other
words, DON'T GIVE COPIES OF THIS PROGRAM TO YOUR FRIENDS! (by
the way, we were just joking about Vinnie. But if you do partic-
ipate in this illegal activity, we will be mighty hurt.)
A copy of the latest SHAREWARE version is included on the
distribution disk for you to pass around.
Introduction
CDPlay is a full featured program which will allow your CD-
ROM player to play a CD Audio disc. In order for CDPlay (herein
referred to as CDP) you need to have the following:
- A IBM Compatible computer
- A CD-ROM drive capable of audio output
- MSCDEX v2.1 or later
If you have the items listed above, you are all set to start
enjoying CDP!
Note: Your CD-ROM device driver MUST support Audio Play-
back. We have encountered a few users whose device drivers do
not support audio. If CDPlay does not run, check with the drive
manufacturer for an updated device driver.
Optional equipment:
- A Microsoft/Logitech compatible mouse
- A Hard drive (although a floppy will work)
Version 1.26 Features
This is a major update to previous versions of CDPlay. It
incorporates all previous updates from 1.24 in it. My spelling
has been checked again and again throughout the screens.
The Music Bar has been done away with, sort of. Instead of
it, you can now select songs directly from the song title window.
The size of the song titles has also been enhanced, allowing
for easier identification of some songs (ie. Classical pieces).
An update after 1.24 (I call it 1.25, but it was never
released) which is incorporated into 1.26, allows the user to
select whether or not they want direct screen writes. By using
this, the user will have super fast screen writes. By not using
it, things will slow down considerably, but may help some prob-
lems that may be occurring in certain window packages. Sorry,
but I can't use these on my 8088, so I can not test to be sure.
Besides, I don't like windowing systems!
Version 1.24 Features
Problem with program displaying track number in hex fixed, I
think. Unfortunately, this problem only occurred on certain
machines... mine was not one of them.
Version 1.22 Features
Version 1.22 does away with the three second delay to deter-
mine if a disc is playing when CDPlay initially loads.
Getting Started
In order for CDP to start working, you need to run the
program CDPSETUP. This program will write the following files to
your system:
CONFIG.CDP (8 bytes)
CDPDISC.DAT (0 bytes)
CDPSONG.DAT (0 bytes)
CONFIG.CDP contains startup information for CDP to use. It
has a file length of 8 bytes.
CDPDISC.DAT and CDPSONG.DAT will both have file sizes of 0
bytes, but don't worry! They don't have any information in them
yet.
During the running of CDP, you will see two other files
appear on your system:
CDPDISC.BAK
CDPSONG.BAK
These are backup files of CDPDISC.DAT and CDPSONG.DAT. They
will be discussed a bit later.
Now, back to CDPSETUP. You will be asked for the amount of
time for the screen saver to become active. The value you enter
is in minutes, from 1 to 30. The screen saver will become active
after the number of minutes you specify if there has been no
keyboard or mouse button activity.
Next, you will be asked if you want Direct Screen Writes.
Tell it yes. If you have problems while running CDPlay, run
CDPSETUP again, and change your answer to no.
****************************************************************
NOTE: If you are upgrading from a version of CDPlay less than
1.26, you MUST RUN CDPSETUP! A new feature (direct screen
writes) has been added and the program MUST know what you want.
****************************************************************
Running CDPlay
To run CDPlay, just type:
CDP <Enter>
at the DOS prompt. CDP will load and you will soon be greeted
with the main program screen.
The Database
The Database section of CDP is very simple. It allows you
to see just what is on a disc, what disc is in the drive, the
times of each track, and the disc artist. It also allows you to
search your database to find a song.
Suppose that you have every disc that the Rolling Stones
currently have out, and you want to find out which discs contain
the song "Jumpin' Jack Flash". The Search portion of the data-
base will tell you.
How To Enter A Disc
Into The Database
Entering a disc into the database couldn't be easier. Just
insert a disc into the CD-ROM drive. CDP will check your current
database entries for that disc. If CDP cannot find the disc, you
will be prompted to enter the disc information.
To add the disc, just follow the prompts. You will first be
asked to enter the Title Of The Disc. You have 80 characters for
each field. As you type, your cursor will move from left to
right. When you get to what appears to be the end of the field,
the text will start to scroll from right to left.
Next, you will be asked to enter the Disc Artist. This is
usually a particular singer or group. If the disc is one of the
'CD Samplers' with songs from many artists, it is suggested that
you type 'Various' in this field.
After you have entered the disc name and artist, you can
start entering the title of each track. Again, you have 80
characters to describe each track.
If, for some reason, you do not feel like entering all this
information, but would like to enter it at a later time, you can.
Just press ENTER for each field. The information will be stored
in the database this way, but can be changed. See the section
entitled 'Editing an Entry' below.
Editing An Entry
If you find you have made a mistake on an entry, or wish to
enter some information which you have previously skipped, you
can.
First, insert the disc whose database entry you wish to
change into the drive. CDP will read the information out of the
database and will display it on the screen.
Next, press Alt-E or click the mouse on the Edit button.
You will be presented with the Entry/Edit screen. You can use
the normal cursor control keys to scroll around the fields and
change them.
If you wish for a field to remain as it is, just hit ENTER
to go on to the next field.
Searching The Database
Searching the database is as easy as entering information
into it.
Press Alt-S or click the mouse on the Search button. You
will now see the Search Query screen. You are asked to enter a
song title, or part of a song title. Enter this and press ENTER.
The disc title, artist, and song title will be displayed. Press
any key to continue searching.
For example, say you want to find all songs titles that
contain the word 'love' in them. Enter 'love' in the search
field. The database will show you all the songs you have entered
which have 'love' in the title.
Note that the database will also show you songs titles which
also have the word 'lovely', 'clove', 'glove', and 'loved'. This
is normal.
To exit a search at any time, press the ESC key, or press
any other key to continue the search.
The Player Section
Now for the good stuff, the actual disc player! I am
assuming you know how to use the mouse by now, so I will not
refer to it any more in this document. Just assume that when I
say something like "Press the P key" that you can also press the
Play/Pause button with the mouse.
So go ahead. Press the P key! This is the Play/Pause key.
It will start a stopped/paused disc and pause a playing disc.
The S key will stop a playing disc. When you press Play, it
will start over at the beginning of the disc.
The + and - keys will allow you to jump forward or backward
one track. If you try to jump forward when listening to the last
track, it will be ignored. If you try to jump backward while
listening to the first track, it will start over at the beginning
of the song.
By pressing the < and > keys, you will jump forward or back
10 seconds on the disc. Please note that this is not 10 seconds
relative to the song, but 10 seconds relative to the disc.
If you press E, you will eject the disc from the drive. You
can also eject the disc by hitting the EJECT button on the front
of your CD-ROM drive.
The Q-Channel Information
The CD Audio disc Q-Channel information is constantly dis-
played on the left side of the Player Interface. Q-Channel
information is the time that is encoded on the disc itself.
Please note that the times that are displayed do not always look
correct, but they are.
For example, you might notice that the Elapsed Track Time is
somewhere around two (2) seconds behind the Elapsed Disc Time.
This is normal.
The Q-Channel information is displayed as:
Track : (current track playing)
Elap. Time: (elapsed Track Time)
Song Time: (Time of TRack)
Elap. Disc: (Elapsed Disc Time)
Total Disc: (Total running time of disc)
Status : CD Player status
Track shows the current track number that is playing. Elap.
Time is the elapsed running time of the currently playing track.
Song Time is the total running time of the track. Elap. Disc is
the elapsed running time of the currently play disc. Total Disc
shows the total running time of the disc. Status shows the
current status of the CD player. It will show Playing, Paused,
Stopped, or Door Open.
The Song Window
By clicking the mouse on a song title in the Song Title
window, you can jump directly to that song and it will start
playing. This can be done from either a stopped or playing disc
(thanks to all the users for suggesting this!).
This should make the program a bit more flexible if you use
it in a DJ capacity and want to access a song way into the disc.
Other songs can be selected in the window by clicking the
mouse on the UP and DOWN arrows. This will scroll through the
list of songs.
If a song is currently playing, and if it is shown in the
window, it will be highlighted.
Exiting the Program
You can exit the program at any time by pressing the F10
key. When you do exit the program, any currently playing disc
will continue to play, so that you can continue to listen to
music while you use your computer.
Note that there is no mouse button available for this. This
is intentional - it keeps you from accidentally hitting the mouse
button and exiting the program. It had originally been placed in
the program, but while programming we kept leaving the program
accidentally!
Regular Maintenance
Like all things, in order to keep your program running
smoothly, you should perform some regular maintenance on CDPlay.
This involves nothing more than backing up four files:
CDPDISC.DAT
CDPSONG.DAT
CDPDISC.BAK
CDPSONG.BAK
These files are your database. If you loose them, you have
to start entering the information all over. Believe me, it has
happened to me many times.
If, for some reason, your database becomes corrupted, there
is only one way to restore it. Delete the files CDPDISC.DAT and
CDPSONG.DAT, then run CDPSETUP again.
Again, make sure you make backups of the database every so
often. If you do not, you will have to re-enter all that infor-
mation! IT IS NOT FUN! Copy the files over to a floppy and put
it in a safe place. That way, if you accidentally destroy the
database, or it becomes corrupted, you can easily restore it.
Remember, "The stingy man spends the most!"
Closing Comments
We hope you receive much enjoyment from using CDPlay. A lot
of hard work and effort went into the creation of this program.
I would like to thank Dave Perry, W4KGU, and Craig Martin,
WA0WPJ, for their help and especially for allowing me to bounce
ideas off them. Thanks also go to Frank Gunja, N0FMR, for being
a very helpful Beta tester. Fortunately I did not screw up his
system! I would also like to thank all the creators of the
Commercial CD player programs. If it wasn't for their extremely
high priced do nothing programs, I wouldn't have written this
one!
Note to Some Drive Users
It has been brought to my attention that some CD-ROM drives
will do things that you are not expecting. The most common one I
have heard of is with a couple models of NEC drives. It seems
that even when a disc is not in the drive, the BUSY light stays
on.
The reason for this, after talking with a rep from a NEC
dealer, is that the drive BUSY light is on whenever a) the drive
is playing a disc or b) a program is accessing the drive for
information - which CDPlay does all the time. Even when there is
no disc in the drive, CDPlay monitors the drive to see if a disc
has been inserted. It also watches the drive when a disc is
stopped, to see if the user has ejected the disc.
So if you see your busy light on all the time, it is just
CDPlay!
Another problem seems to be occurring with the new low
priced drives from Radio Shack and a few others. Due to the SLOW
times of these drives, CDPlay slows way down also. It seems to
take forever to jump back and forth between tracks. This is not
due to CDPlay. This program can only run as fast as your drive
supplies it with information.
BIOS Problem?
I have been receiving some complaints from a few users about
the way in which CDPlay shows the track number. After many hours
of work and a lot of consultation with C programmers, we have
come to the conclusion that this is a BIOS problem. If your
machine counts like this: 1, 2, 3, 4, 5, 6, 7, 8, 9, 16, 17, ....
please let me know!
I need the following information from you:
Drive manufacturer/model number
MSCDEX version number
drive manufacturer's device driver version number
BIOS manufacturer and version
Make/model of computer
This data will be collected and sent to the BIOS maker. Who
knows what other programs you may have that are being effected by
this same bug!
About the Author
Randy Rathbun, NV0U, is a graduate of the University of
Missouri at Kansas City withe a degree in Computer Based Informa-
tion Systems. He received his amateur radio license in April
1985 (KA0UMC). Other than computers and ham radio, Randy's hob-
bies are home beer/wine making, listening to blues music, reading
science fiction, and stamp collecting.
User Notes
CDPlay was written in Turbo C++. It was written using a
Sony CDU-510 CD-ROM drive, MSCDEX v 2.21, MS-DOS 5.0, and an 8088
IBM Compatible computer.
CDPlay should work correctly with ANY CD-ROM drive, provided
the driver program manufacturer has stuck with the Microsoft CD
ROM Extensions Device Driver specifications. CDPlay does not
talk to the drive, like some drive specific programs do, but
talks to the CD-ROM extensions which in turn talks with the
drive. This makes for a more compatible program. If, after you
have tried everything you know of to get the program running, and
it still does not work correctly then WRITE US A LETTER! We want
to know! Please include the following information to us in your
letter:
- a printed copy of your AUTOEXEC.BAT file
- a printed copy of your CONFIG.SYS file
- what version of MSCDEX you are running
- what version and what device driver you are using
We will try our darndest to help you get the program running.
Versions Released or Versions We Worked On
CDPlay
Version Date Changes made
1.26SR 920929 (sound of 'Taps' being played). Death
to the Music Bar! Now you can access
a song directly in the display window.
Also made the display window larger to
display song names with HUGE titles,
ie. classical music and Mojo Nixon's
'Debbie Gibson Is Pregnant With My Two
Headed Love Child.' The main screen
layout has also undergone major rest-
ructuring. The documentation included
in both the Registered and Shareware
versions are the same. I got sick of
editing two different files each time I
had an upgrade.
1.25SR*# 920901 Added support for both direct and BIOS
screen writes. This should make the
program work a little better under some
windowing systems. Sorry I can't test
this out to be sure. This XT does not
multitask too well!
1.24SR 920702 Corrected problem with program displaying
track numbers above 10 in hexadecimal.
1.23SR 920401 Corrected a small typo.
1.22SR 920327 Did away with three second delay when
the program is executed. CDPlay now
checks a status bit to see if the drive
is playing an audio disc upon startup.
1.21SR 920323 Made some additions to the registration
information to cut down on confusion.
Also fixed problem with Search routine
showing duplicate information when the
search criteria matched the last disc in
the database.
1.20SR 920311 MAJOR BUG FOUND! The way which CDPlay
wrote the database meant certain death
for anything that was already in the
database. This bug has been fixed.
Sorry for any problems. Free copies sent
to all REGISTERED users.
1.12S 920221 Made changes to annoy screen. No longer
sits forever. Also cut down on number
of times that the screen is displayed.
1.11SR 920216 As usual, I got ahead of myself and did
not pay attention to what was being put
on the screen. So this version does not
do anything differently, it just corrects
my failure to read what I wrote in the
help screen. Uploaded to Ham Shack BBS
only.
1.10SR 920211 Release of updates.
1.05# 920210 Made change to annoyware screens instead
of cripple ware. Lowered price to $10.
1.04# 920209 Corrected problem in search routine. Can
now exit a search. No longer have to go
through every entry.
1.03# 920208 Added Music Bar to screen. Fixed problem
with mouse acting too quickly.
1.02a# 920207 Made room in code for password
registration. This will not be done
until much later (say v1.20 or later).
1.02# 920205 Moved the screen format around to
facilitate the new upcoming features.
1.01S 920118 Fixed typo in order screen, along with
other small typos. The CDPlay release
also contains CDPlay Quick Start.
1.00S 920115 First Shareware Version Released!
0.60B 920111 Fixed bugs (screen) introduced in v0.22B
0.50B 920110 Fixed stop disc function to return to
beginning of disc.
0.22B 920107 Released BETA TEST version. Contains fix
for initial startup recognition of
playing disc.
0.21B 911219 Initial BETA TEST of CD Play
0.01B 910921 Start of CDPlay coding.
NOTE: * indicates changes made to CDPSETUP.
# indicates version not released.
S indicates Shareware version.
R indicates Registered version.
B indicates Beta version.
CD Play
Product Order Form
Name: __________________________________________________________
Address: _______________________________________________________
City: _____________________________ State: _____________________
Zip: ____________________
Version you are registering _____________
Media type: ________ 3.5" ________ 5.25"
______ units @ __$10__ ea. = _______
+ shipping 3.00
TOTAL _______
Send your Check/Money Order payable to Randy Rathbun to:
Randy Rathbun
18602 Cheyenne Drive
Independence, MO 64056-2082
International orders must be in United States Funds ONLY. Inter-
national orders should add $3.00US for increased shipping costs.
From where did you receive this program? (if a BBS, list its
name/phone number: ______________________________________________
Please let us know what you think about the program! Are there
any things you would like to see added or changed? Is there
anything that is not working properly for you? Drop us a note
(or write it on the back of this form if you print it out).
Remember, we may write it, but you are the ones that use it!
For our use only:
PIDNO: ___________________________________________________
TYPE: ________